home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Vk / VkPrefDialog.z / VkPrefDialog
Text File  |  1998-10-20  |  8KB  |  199 lines
  1.  
  2.  
  3.  
  4. VVVVkkkkPPPPrrrreeeeffffDDDDiiiiaaaalllloooogggg((((3333xxxx))))                                              VVVVkkkkPPPPrrrreeeeffffDDDDiiiiaaaalllloooogggg((((3333xxxx))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      VkPrefDialog - Preference dialog interface for preference package
  10.  
  11. IIIINNNNHHHHEEEERRRRIIIITTTTSSSS FFFFRRRROOOOMMMM
  12.      VkGenericDialog : VkDialogManager : VkComponent : VkCallbackObject
  13.  
  14. HHHHEEEEAAAADDDDEEEERRRR FFFFIIIILLLLEEEE
  15.      #include <Vk/VkPrefDialog.h>
  16.  
  17. PPPPUUUUBBBBLLLLIIIICCCC PPPPRRRROOOOTTTTOOOOCCCCOOOOLLLL SSSSUUUUMMMMMMMMAAAARRRRYYYY
  18.    CCCCoooonnnnssssttttrrrruuuuccccttttoooorrrr////DDDDeeeessssttttrrrruuuuccccttttoooorrrr
  19.            VkPrefDialog(const char* name,
  20.                         VkPrefItem* item = NULL);
  21.            virtual void ~VkPrefDialog(void);
  22.  
  23.  
  24.    AAAAcccccccceeeessssssss FFFFuuuunnnnccccttttiiiioooonnnnssss
  25.            VkPrefItem* item(void);
  26.  
  27.  
  28.    SSSSeeeettttttttiiiinnnngggg IIIItttteeeemmmm
  29.            void setItem(VkPrefItem* i);
  30.  
  31.  
  32. CCCCLLLLAAAASSSSSSSS DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  33.           The VkPrefDialog class is an abstract class that supports easy-to-
  34.           use preference dialogs using VkPrefItem and its subclasses.
  35.           Applications pay attention only to the preference item values and
  36.           let VkPrefItem and VkPrefDialog handle formatting and user
  37.           interaction.  Applications can also use the VkPrefDialog class
  38.           without subclassing, by using the VkPrefDialog::prefCallback
  39.           instead.
  40.  
  41.  
  42.  
  43. DDDDEEEERRRRIIIIVVVVIIIINNNNGGGG SSSSUUUUBBBBCCCCLLLLAAAASSSSSSSSEEEESSSS
  44.           Derived classes should override the _o_k(), _c_a_n_c_e_l(), and _a_p_p_l_y()
  45.           member functions.  These are called when the user presses the OK,
  46.           Cancel, and Apply buttons, respectively.  VkPrefDialog will not call
  47.           _V_k_P_r_e_f_I_t_e_m::_u_p_d_a_t_e_V_a_l_u_e() until after these callbacks are invoked,
  48.           so the derived code can call _V_k_P_r_e_f_I_t_e_m::_c_h_a_n_g_e_d() to see if
  49.           individual preference item values have changed since the last
  50.           activation.
  51.  
  52.  
  53.  
  54. FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNNSSSS
  55.    VVVVkkkkPPPPrrrreeeeffffDDDDiiiiaaaalllloooogggg(((())))
  56.            VkPrefDialog(const char* name,
  57.                         VkPrefItem* item = NULL);
  58.            virtual void ~VkPrefDialog(void);
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. VVVVkkkkPPPPrrrreeeeffffDDDDiiiiaaaalllloooogggg((((3333xxxx))))                                              VVVVkkkkPPPPrrrreeeeffffDDDDiiiiaaaalllloooogggg((((3333xxxx))))
  71.  
  72.  
  73.  
  74.           Create a preference dialog.  The second argument is the single
  75.           preference item for the dialog.  Usually, this item will be a
  76.           VkPrefList containing multiple preference objects.
  77.  
  78.    iiiitttteeeemmmm(((())))
  79.            VkPrefItem* item(void);
  80.  
  81.  
  82.           Returns the preference item associated with this preference dialog.
  83.  
  84.    sssseeeettttIIIItttteeeemmmm(((())))
  85.            void setItem(VkPrefItem* i);
  86.  
  87.  
  88.           Changes the preference item associated with this preference dialog.
  89.  
  90. DDDDAAAATTTTAAAA MMMMEEEEMMMMBBBBEEEERRRR DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNNSSSS
  91.    ____iiiitttteeeemmmm
  92.            VkPrefItem* _item;
  93.  
  94.  
  95.           The preference item for this dialog
  96.  
  97.    pppprrrreeeeffffCCCCaaaallllllllbbbbaaaacccckkkk
  98.           static const const char* prefCallback;
  99.  
  100.  
  101.           A callback function providing an alternative to subclassing
  102.           VkPrefDialog.  The callback will be called with reasons of
  103.           _V_k_D_i_a_l_o_g_M_a_n_a_g_e_r::_O_K, _V_k_D_i_a_l_o_g_M_a_n_a_g_e_r::_A_P_P_L_Y, and
  104.           _V_k_D_i_a_l_o_g_M_a_n_a_g_e_r::_C_A_N_C_E_L.
  105.  
  106. IIIINNNNHHHHEEEERRRRIIIITTTTEEEEDDDD MMMMEEEEMMMMBBBBEEEERRRR FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNNSSSS
  107.    IIIInnnnhhhheeeerrrriiiitttteeeedddd ffffrrrroooommmm VVVVkkkkGGGGeeeennnneeeerrrriiiiccccDDDDiiiiaaaalllloooogggg
  108.            VkGenericDialog(),  ~VkGenericDialog(),
  109.  
  110.  
  111.    IIIInnnnhhhheeeerrrriiiitttteeeedddd ffffrrrroooommmm VVVVkkkkDDDDiiiiaaaallllooooggggMMMMaaaannnnaaaaggggeeeerrrr
  112.           show(), hide(), prepost(), setTitle(), setButtonLabels(), unpost(),
  113.           unpostAll(), centerOnScreen(), lastPosted(), post(), postModal(),
  114.           postBlocked(), postAndWait(), _action, _ _showOK, _showCancel,
  115.           _showApply, _allowMultipleDialogs, _minimizeMultipleDialogs,
  116.           prepostCallback,
  117.  
  118.  
  119.    IIIInnnnhhhheeeerrrriiiitttteeeedddd ffffrrrroooommmm VVVVkkkkCCCCoooommmmppppoooonnnneeeennnntttt
  120.           installDestroyHandler(), removeDestroyHandler(), widgetDestroyed(),
  121.           setDefaultResources(), getResources(), manage(), unmanage(),
  122.           baseWidget(), okToQuit(), _name, _baseWidget, _w, deleteCallback
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. VVVVkkkkPPPPrrrreeeeffffDDDDiiiiaaaalllloooogggg((((3333xxxx))))                                              VVVVkkkkPPPPrrrreeeeffffDDDDiiiiaaaalllloooogggg((((3333xxxx))))
  137.  
  138.  
  139.  
  140.    IIIInnnnhhhheeeerrrriiiitttteeeedddd ffffrrrroooommmm VVVVkkkkCCCCaaaallllllllbbbbaaaacccckkkkOOOObbbbjjjjeeeecccctttt
  141.           callCallbacks(), addCallback(), removeCallback(),
  142.           removeAllCallbacks()
  143.  
  144.  
  145. CCCCLLLLAAAASSSSSSSSEEEESSSS UUUUSSSSEEEEDDDD BBBBYYYY TTTTHHHHIIIISSSS CCCCLLLLAAAASSSSSSSS
  146.      VkPrefItem
  147.  
  148. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  149.      VkGenericDialog, VkDialogManager, VkComponent, VkPrefItem
  150.      _V_i_e_w_K_i_t _P_r_o_g_r_a_m_m_e_r'_s _G_u_i_d_e
  151.      _T_h_e _X _W_i_n_d_o_w _S_y_s_t_e_m, DEC Press, Bob Sheifler and Jim Gettys
  152.      _T_h_e _X _W_i_n_d_o_w _S_y_s_t_e_m _T_o_o_l_k_i_t, DEC Press, Paul Asente and Ralph Swick
  153.      _T_h_e _O_S_F/_M_o_t_i_f _P_r_o_g_r_a_m_m_e_r_s _R_e_f_e_r_e_n_c_e, Prentice Hall, OSF
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.